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in RX01 systems. This document describes the minimal system requirements, 
the files distributed in the kits, the options available for planning and con¬ 
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appendices present a further treatment of material covered in the guide. 
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DOCUMENTATION CONVENTIONS 





All monitor and system program command lines are terminated by press¬ 
ing the RETURN key. Since this is a non-printing character, at certain 
places in the text the notation ( «» ) represents the RETURN key. 

In examples of keyboard dialogue, user input is underlined , but monitor 
output and program output are not. 

In format descriptions, uppercase characters represent information 
that must be entered exactly as shown; lowercase characters represent 
variable information that must be supplied by the user. 

Some special keyboard characters require that the CTRL (control) key 
be pressed simultaneously with a second character. These characters 
are denoted by + (up arrow); for instance, tZ (CTRL Z). 

Ellipsis marks (...) indicate one or more words were eliminated within 
a passage but without altering the meaning of the passage. 
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1.0 INTRODUCTION 


This installation guide provides you with the step-by-step instruc¬ 
tions you need to install the FORTRAN IV compiler and Object Time 
System (OTS) in the RT-11 operating system. This information is 
predicated on a booted and running RT-11 system. Table 1 lists the 
sources of additional information you might find useful in building 
your FORTRAN IV system. 


Table 1 


Where to Find 

More Information 

Subject 

Source of Information 

Blank disk formatting 

Appendix B, SGM 

Bootstrapping 

Appendix A, SGM 

Configuring (creating) a 

Chapter 2, SGM 

minimal system device 


VIRTUAL arrays 

Appendix D, LRM 

Key: 


SGM - RT-11 System Generation Manual 

LRM - PDP-11 FORTRAN Language Reference Manual 


1.1 Installation Errors 

If you make errors within an installation section, go back to the 
beginning of the section and repeat the steps. Correct any typing 
errors by using the standard RT-11 input techniques RUBOUT and CTRL/U. 


1. 2 Installation Requirements 

The following steps are required for a successful installation. 

a. Select the installation options 

b. Prepare to install 

c. Copy files from the distribution media to the system device 
(MT only) 

d. Select the compiler defaults 

e. Build the compiler 

f. Build the OTS 

g. Verify (system build and test) 


1.3 System Requirements 

The software included in this distribution requires the following sys- 
tem components for normal use. 
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RT-11 Version 3 Single Job (SJ), 
or Extended Memory (XM) monitor 


Foreground/Background (FB), 


PDP-11 processor (any) 


Minimum 8K words of memory for installation and compilation. 
The baseline SJ monitor is required for FORTRAN 
installation if the hardware configuration pro¬ 
vides only 8K words of memory. See Appendix G 
for instructions on installing FORTRAN in an 8K 
system. 

Minimum 135-209 contiguous blocks for compiler .SAV image. 

Minimum 130-180 contiguous blocks for the OTS library. 

These space requirements must be observed care¬ 
fully in RX01 operating systems because they 
require special OTS installation procedures. 


1.4 Distribution Files 


I 


The FORTRAN IV, Version 2, software is supplied on the following media. 

1 RL01 disk cartridge 
1 RK05 DECpack 

1 RK06 disk cartridge 

2 RX01 diskettes 
2 TU56 DECtapes 

1 7-track magnetic tape 
1 9-track magnetic tape 


All distribution media must be WRITE PROTECTed or WRITE LOCKed, as 
applicable to disk or tape. Be sure that no write ring is inserted 
at the back of the tape reel. Make certain, if the tape is TM-11, 
that the magtape is positioned at the load point. If it is not, re 
wind it manually. 


1.4.1 File Contents 
See Appendix A. 


1-4.2 Adapting Your System Device for FORTRAN IV 

Before you build the FORTRAN IV system, the RT—11 operating system must 
hsve been copied onto the target medium which becomes now your system 
device. You will need to make room for FORTRAN IV if your system medium 
is DECtape, single platter RFll disk, single platter RJS03/4 disk, or 
floppy disk. The process you must follow to create a minimal system 
device is detailed in Chapter 2 of the RT-11 System Generation Manual 
and in Section 3.1 of this guide. This process is not required if your 
| operating system device is RL01, RK05, RP02, RP03, RK06, multiple 
platter RFll or multiple platter RJS03/04. 


2.0 INSTALLATION OPTIONS 


At installation time, the RT—11 operating system will engage you in an 
interactive dialog by means of system prompts. Your replies to the FORTRAN 
installation program's questions will determine your default library, the 
kind of code the compiler generates, match the available code to your 
interfacing hardware configuration, including hardware options, and 
other options and parameters available at installation time. Examples 
of the system's prompts are shown in Appendix B.l for compiler installa¬ 
tion and in B.2 for OTS installation. 
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Various options and parameters are available at installation time for 
your particular site. Prior to actual installation you must decide on 
your default system. The RT-11 FORTRAN System Subroutines (SYSF4) is 
a collection of routines provided on the distribution media as a file 
of concatenated object modules (SYSF4.0BJ). These modules interface 
with and can be called directly by FORTRAN thus allowing you as a 
FORTRAN user to utilize certain features of the RT-11 SJ and FB 
monitors as well as utility functions. You can create a library by 
using the Librarian to transform SYSF4 into a library file (SYSLIB). 

If this file (SYSF4) is linked directly with the FORTRAN program, all 
SYSLIB modules will be included even though not all are used. When 
SYSLIB is used in a default system library, it becomes SYSLIB.OBJ and 
the Linker uses it to resolve undefined globals. SYSLIB.OBJ is then 
resident on the system device (SYs). In addition to SYSF4 and FORLIB, 
SYSLIB.OBJ can also include user routines that you have written. This 
process is covered in detail in this chapter. 


2.1 FORTRAN IV Compiler Installation Options 

When you install the FORTRAN IV compiler you can make the following 
parameter changes which will be patched into the compiler .SAV image 
by the installation program FORGEN.SAV. 


2.1.1 Listing Page Size 

The compiler, as supplied, is set to a maximum of 56! „ lines per page 
for the compilation listing. You can change this parameter to any 
value greater than 0 for non-standard line printers. 


2.1.2 Record Size 

You can change the default maximum formatted record size for run-time 
I/O, allocated at 136 10 characters (bytes) to any new value between 4 
and 4095 (inclusive). You can override the default value at compile¬ 
time by using the /RECORDSIZE :n compiler command option. 


2.1.3 Number of Logical Channels 

This parameter specifies the default maximum number of logical channels 
which can be open simultaneously under a FORTRAN IV program. The com¬ 
piler, as supplied, pre-sets this value to 6 for the allocation of file 
descriptor blocks at run-time. This value must be in the range 1-15 
inclusive. You can change it at compile time by using the /UNITS:n 
compiler command option. 


2.2 Keywords and Options 

Several keywords and options of the FORTRAN IV OPEN and CLOSE statements 
are valid only for specific operating systems and apply uniquely to the 
file services of the given system. These are covered in detail in the 
RT-ll/RSTS/E FORTRAN IV User's Guide. You can use the RSTS/E switch 
/X:xxx (cross compile) to specify which one of three systems you are 
selecting for your FORTRAN IV program. The values are: 
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RT (for RT-11) 

RST (for RSTS/E) 

RSX (for RSX-11) 

The default value for this switch is RT. You can set this value at 
installation time to any of the three values and can override it at 
compile time on a per program unit basis by invoking FORTRAN with the 
RUN command and using the RSTS/E /X switch. 


2.3 Compiler Generated Code 


The FORTRAN IV compiler produces both threaded code and inline code. 
You can select either or both at installation time. Threaded code 
consists of the addresses of routines which are invoked by FORTRAN to 
perform specified actions without any need for recompilation. Inline 
code consists of OTS modules which interface with and drive designated 
arithmetic hardware. Inline code interfaces with the following hard¬ 
ware options: 


FP11 

KEll-A, B 
KE11-E 
KE11-F 
KEV11 


Floating Point Processor 
Extended Arithmetic Element 
Extended Instruction Set 
Floating Instruction Set 
Extended Arithmetic Chip 


(FPU)* 

(EAE) 

(EIS) 

(FIS) and (EIS) 
(EIS, FIS or THR) 


Table 2 correlates inline code to the type of hardware option it inter¬ 
faces . 


Table 2 

OTS Module/Hardware Option 



y = YES 


*Note that the FORTRAN compiler does not generate inline 
code for FPU, but inline code for EIS or FIS can interface 
with the OTS FPU library. 
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Inline code generally produces superior run-time results in terms of 
faster execution speed and minimal program size. You can take advan¬ 
tage of any arithmetic hardware by changing the default type code 
(threaded) supplied with the compiler. You can override the default 
selected at installation time by using the /CODE:xxx compiler command 
option at compile time. 


2.3.1 Speed or Size Optimization for Inline Code 

You have the option of optimizing for either speed or size when the 
inline compiler generates certain code sequences. Your selection of 
one excludes the other. When you choose optimization for size, float¬ 
ing point code sequences can be as much as four times smaller, but can 
take longer to run because OTS routines are called to pass floating 
point values on the stack. You will find that optimization for speed 
is beneficial where your program does not need to be minimized for 
size and does not require many floating point operations. You select 
the default optimization at installation time but you can override at 
compile time as follows: 

To optimize for size, use 

/NOOPTIMIZE:SPD compiler command option 

To optimize for speed, use 

/OPTIMIZE:SPD compiler command option 


2.3.2 Compiler Build Selection 

When you select your default code, the system will prompt you for your 
choice of a copy of a threaded only compiler, or an inline only, or 
both. In effect, the system offers you a full compiler (both codes) or 
a streamlined compiler (one code only). Your intended use of the system 
will determine your choice. If you anticipate that you will use the 
default code selector all the time, you will choose to save space on 
the system device by accepting the streamlined compiler. The approxi¬ 
mate sizes of each of the three compilers are: 

Threaded only 135 blocks 

Inline only 180 blocks 

Full compiler 209 blocks 

If you decide to have the compiler generate only inline code, you can 
optimize the FORTRAN OTS for smaller size by omitting the two modules 
V2S and V2NS• Only the threaded compiler references these modules 
hence they are superfluous to the inline compiler. Conversely, if you 
select the threaded code compiler, you should direct that one — but 
not both — be built into the FORTRAN OTS. V2S modules check subscripts 
to determine whether an array subscript reference is within the bounds 
of the program. V2NS modules do not check array subscripts and are 
used when bounds checking is not desired. 


2.4 OTS Library Installation Options 

Your choice of OTS options is determined by your intended use of the 
system, the amount of storage available for your program and your pro¬ 
gramming practices. The FORTRAN installation program will prompt for 
your selection of OTS modules, specify the configuration requirements 
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for their inclusion, and define those modules which are not applicable 
to your particular installation. Some OTS modules run only on certain 
hardware and are therefore selected for assembly in accordance with 
those configurations. Refer again to Table 2. 


The OTS installation procedure generates one default FORTRAN OTS library 
and any number of alternate OTS libraries which can be tailored for 
different services. Usually, only the default library is needed for 
FORTRAN operation. 


2.4.1 SYSLIB or FORLIB Decision 

Although the OTS normally is installed into the default system library 
SYSLIB.OBJ, you can direct the placing of the OTS into its own individual 
file FORLIB.OBJ. This separates FORLIB.OBJ from the other routines in 
the system library. When you place the OTS in SYSLIB, the Linker auto¬ 
matically searches SYSLIB to resolve any undefined global references. 
However, if SYSLIB contains user-written routines which are linked with 
non-FORTRAN programs more often than the FORTRAN OTS is linked with 
FORTRAN programs, your better option is the separate FORLIB.OBJ. In 
addition, your selection of SYSLIB and a separate FORLIB could decrease 
the SYSLIB search time the Linker requires for non-FORTRAN programs. 

You also have the choice of combining all the user-written routines, 
if there are many, into a third and separate library. 


2.4.1.1 RT-11 Constraints - Unless your system is subject to file storage 

constraints, your operation will benefit when you add the OTS modules to 
SYSLIB, thus forming the file SY:SYSLIB.OBJ. However, if your OTS library 
must reside on a separate device, you will build the separate file 
FORLIB.OBJ. 


NOTE 

When you add the OTS modules to SYSLIB, the 
installation program assumes the existence 
of file SY:SYSLIB.OBJ. 


2.4.2 VIRTUAL Support 

FORTRAN IV supports the use of VIRTUAL arrays on PDP-11 processors 
equipped with the KTll Memory Management Unit. See the PDP-11 FORTRAN 
Language Reference Manual for a description of VIRTUAL and the RT-11/ 
RSTS/E FORTRAN User's Guide for some applications of VIRTUAL. RT-11 
supports VIRTUAL under the SJ and FB monitors and under the XM monitor. 
Since the routines differ, under the SJ/FB monitors, from those for the 
XM monitor, you must decide which library will support VIRTUAL. Programs 
using VIRTUAL arrays linked with a library for the SJ/FB monitors can¬ 
not run under the XM monitor. The converse is also true. 

However, if your FORTRAN IV program uses VIRTUAL arrays and is run under 
both the SJ/FB and the XM monitors you must generate an alternate 
library. In this case you should cause two .SAV images of the program 
to be made — one linked with an SJ/FB VIRTUAL library, the other 
linked with an XM VIRTUAL library. 

» i 
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2.4.3 RUNTIME Bounds Checking for Threaded Code 


The FORTRAN OTS includes the option of run-time array subscript check¬ 
ing for compiler-generated threaded code. Refer to 2.3.2.1 on the sub¬ 
ject of modules V2S and V2NS. If you have included V2S into your OTS, 
every destructive array reference made by a program linked to the li¬ 
brary is checked to insure that the element to be stored is within 
program bounds. 

Your decision whether to use these OTS modules will be determined by 
the following considerations: 

1. The check insures only that the referenced element is I I 

within program bounds — not array bounds. Ij 

The user program, including OTS routines, ct^ild be 
corrupted if the reference subscript exceed^ the bounds 
of the array. 

2. Program execution time could be slower because of the 
extra overhead involved in checking accesses to arrays. 

3. Only non-VIRTUAL arrays are checked. See 2.3. 


2.5 OTS Support for Optional Arithmetic Hardware 

The FORTRAN installation program determines what optional arithmetic 
hardware is present on your system configuration and prompts you for 
your choice of OTS object modules to interface with the hardware op¬ 
tions. You can obtain increased FORTRAN performance by choosing the 
appropriate OTS support for this interface. The installation prompts 
for the OTS options during the configuration of the default OTS library 
for SYSLIB or, alternatively, FORLIB. Your "NO" answer to a prompt 
allows you to choose a different type of hardware support. If you 
are building alternate FORTRAN OTS libraries, you must specify what 
type of hardware support they will include. The optional OTS object 
modules and their hardware interfaces are shown in Table 3. See also 
Table 2. 


Table 3 

OTS Module Interface with Hardware Options 


OTS 

Module 

Hardware Option Interface 

FPU 

FPll 

Floating Point Processor 

EIS 

KE11-E 

Extended Instruction Set 

FIS 

KE11-F 

Floating Instruction Set 


KEV11 

Extended Arithmetic Chip 

EAE 

KEll—A,B 

Extended Arithmetic Element 

NHD 

No specific arithmetic hardware (bare 
machine). Software performs the arith¬ 
metic operations. 


7 













2 »5.1 Stand Alone ($SIMRT) Support Optimization 


If you do not expect to use stand alone FORTRAN support, you can further 
optimize the FORTRAN OTS for smaller size by omitting UNI.OBJ from the 
OTS library. 


3.0 INSTALLATION PROCEDURES 

At this point you are ready to install the FORTRAN IV compiler and the 
FORTRAN OTS into your RT-11 system. The installation of each is covered 
in a separate section. 

The devices you work with and their specifications are shown in Table 4. 


Table 4 

Device Identification 


(n is the numerical designation of the drive unit) 


Device 

Device 

Specification 

RK05 

RKn: 

RK06 

DMn: 

RP02 or RPO3 disk 

DPn: 

RJS03/4 disk 

DSn: 

TCll DECtape 

DTn: 

RX01 diskette 

DXn: 

TU16 magtape 

MMn: 

TU10 or TS03 magtape 

MTn: 

RFll fixed head disk drive 

RFn: 

RL01 disk cartridge 

DLn: 


Note that if you install FORTRAN to floppy disk, be sure that the com¬ 
piler is installed to target floppy 1 of 2, and that the OTS is in¬ 
stalled to target floppy 2 of 2. 


3.1 General Guidelines 


The installation process consists of copying from the distribution 
media to the target (system) media. In some cases, the compiler and 
the OTS will be installed on the same system device (SY:). In other 
cases the compiler and the OTS will each be installed on two different 
devices. These latter are called "full" system devices and consist of 
the RL01 (DLn:), RK05 (RKn:), TC11 DECtape (DTn:) and RX01 floppy disk 
(DXn:). They are called "full" because they contain files which must 
be deleted to make room for FORTRAN. You require a minimum of 380 free 
blocks on your system device to build a FORTRAN system. You must 
retain the following files as a minimum. 

xxMNyy.SYS* 

TT.SYS 

LP.SYS (if your system has a line printer) 

DT.SYS (if the system is not DECtape) 

EDIT•SAV 
LIBR.SAV 
LINK.SAV 
PIP.SAV 


*Substitute the SJ monitor appropriate to your system device? for 
example DXMNSJ.SYS for RX01 systems. 


i 
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Section 2.3.2 of the RT-11 System Generation Manual details the proce¬ 
dures you must follow to build a system back-up for your FORTRAN installa¬ 
tion. You will delete from the back-up those files you do not require when 
you make room for FORTRAN. The back-up device then becomes your system 
master and is treated with the same care as the distribution media. 

Both the distribution media and the system back-up are removed after 
copying and stored in a safe place. Both must be WRITE LOCKed or 
WRITE PROTECTed when they are mounted and the write ring must be re¬ 
moved from a magtape reel. When you copy, you must WRITE ENABLE the 
system device. At installation the distribution medium is given the 
logical assignment to input (INP) and the system medium is assigned 
to output (OUP). 


3.2 Installing the Compiler 

Boot an RT-11 Version 3 monitor (SJ, FB or XM) with the required device 
handlers for the distribution and the target devices. Use the 8K 
monitor if the system configuration is for 8K words. Follow these pro¬ 
cedures to insure a correct installation. 


1. Assign the target physical device to OUP, for example: 
ASSIGN RKO: OUP 


I 

Mount the distribution medium in a free RL01 or 
RKO5 drive and assign the drive to input: 

ASSIGN RKn: INP or ASSIGN DLn: INP 

b. RKO6 distribution 

Mount the distribution medium in a free RK06 drive 
and assign the drive to input: 


2. Mount the distribution medium and make the physical to 
logical assignment for each different medium as follows: 

a. RL01 or RKO5 distribution 


ASSIGN DMn: INP 

Diskette (floppy disk) distribution 

You are working with two diskettes — diskette 1 is 
for the compiler installation; diskette 2 for the OTS. 
Mount diskette 1 in a free DX drive and assign the 
drive to input: 

D* o . o«- p 

ASSIGN DXrf: INP 


■ul 


'L 




d. DECtape distribution 


You are working with two DECtapes -- DECtape 1 is 
for the compiler installation? DECtape 2 for the OTS. 
Mount DECtape 1 in a free TCll drive and assign the 
drive to input: 






ASSIGN DTn: INP 
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e. 


Magtape distribution 


Mount the distribution tape on a free drive and as¬ 
sign the drive to input. 

ASSIGN MTn: INP (for TU10 drive) 

ASSIGN MMn: INP (for TU16 drive) 


3. Invoke the installation indirect command files 

a. Magtape distribution 

Copy the installation indirect command file from the 
distribution tape to the system device, then invoke 
the file from the system device: 

COPY INP:FORGEN.COM SY: 

@F0RGEN 

b. RL01/RK05/RK06/Floppy disk/DECtape distribution 

Invoke the installation indirect command file directly 
from the distribution medium: 

@INP:FORGEN 

Now the FORTRAN installation program and the indirect command files for 
installing the compiler will copy the required files to the output de¬ 
vice (OUP) from the input device (INP). The installation program will 
next offer you options in the form of a question and answer dialog. 

See Appendix B.l for a sample FORTRAN compiler dialog. Preserve these 
files as described in Section 5.4 (Preserving the FORTRAN IV System). 
Your replies will result in the generation of an indirect command file 
(FORBLD.COM) and an object file (OUP:DEFLTS.OBJ). 


3.3 Installing the FORTRAN OTS 

You follow essentially the same procedures for installing the OTS as 
you did when you installed the FORTRAN compiler. Once again, in some 
cases the OTS will be built onto the same system device as the compiler 
(SY:); in others, the OTS will be built on a separate device. The 
separate devices for the OTS are the RK05 (RKn:), TC11 DECtape (DTn:) 
and RX01 floppy disk (DXn:). You build the system back-up from the 
distribution media and carefully preserve both when copying is complete. 
The system back-up will be used when you delete files, as described in 
Section 2.3.2 of the RT—11 System Generation Manual, to make room for 
FORTRAN. You must retain at least the same files as prescribed for 
the FORTRAN compiler in Section 3.1 of this guide. RX01 systems are 
an exception. See section 4 for the minimum files for RX01 OTS 
installation. 

When you copy, both the distribution medium and the system back-up 
must be WRITE LOCKed or WRITE PROTECTed and the write ring must be 
removed from a magtape reel. For copying you must WRITE ENABLE the 
target device. As with the compiler installation, the distribution 
medium is given the logical assignment to input (INP) and the target 
medium is assigned to output (OUP). Follow these procedures to 
insure a correct OTS installation on all but RX01 systems. Follow 
the instructions of Section 4 for floppy disk OTS installation. 

1. Assign the target physical device to OUP; for example, 

ASSIGN RKO: OUP 
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2. Mount the distribution medium and make the physical to 
logical assignment for each different medium as follows: 

a. RL01/RK05 distribution 

Mount the distribution device in a free RK05 or RL01 
drive and assign the drive to input: 

ASSIGN RKn: INP ASSIGN DLn: INP 

b. RK06 distribution 

Mount the distribution device in a free RK06 drive and 
assign the drive to input: 

ASSIGN DMn: INP 

c. Diskette (floppy disk) distribution 

You are working with the second of two diskettes (you 
used the first for the compiler). Mount the distribu¬ 
tion disk in DX drive 1 and mount system diskette 2 in 
a DX drive. Assign drive 1 to input: 

ASSIGN DX1: INP 
ASSIGN DXO: OUP 

d. DECtape distribution 

You are working with the second of two DECtapes (you 
used the first for the compiler). Mount DECtape 2 in 
a free TC11 drive and assign the drive to input: 

ASSIGN DTn: INP 

e Magtape distribution 

Mount the distribution tape on a free drive and assign 
the drive to input: 

ASSIGN MTn: INP (for TU10 drive) 

ASSIGN MMn: INP (for TU16 drive) 

3. Invoke the installation indirect command files for all 
except RX01 systems. See section 4 for RX01 OTS installation 
procedures. 

a. Magtape distribution 

Copy the installation indirect command file from the 
distribution tape to the system device, then invoke 
the file from the system device: 

COPY INP: OTSGEN.COM SY: 

@0TSGEN 

b. RL01/RK05/RK06/Floppy disk/DECtape distribution 

Invoke the installation indirect command file directly 
from the distribution medium: 

@INP rOTSGEN 


11 























Now the FORTRAN installation program and the indirect command files 
for installing the OTS will copy the required files to the output 
device (OUP) from the input device (INP). The installation program 
will next offer you options in the form of a question and answer 
dialog. See Appendix B.2 for a sample FORTRAN OTS dialog. Your 
replies will result in the generation of an indirect command file 
(OTSl.COM) for creating libraries. Preserve this file as described 
in Section 5.4 (Preserving the FORTRAN IV System). 

4.0 RX01 DISKETTE INSTALLATION 

The procedures for installing the second (OTS) diskette are signifi 
cantly different from those for other systems. 

a. Do not use the indirect command file 


OTSGEN.COM 


b. You install the OTS manually and you will need the follow¬ 
ing files as an absolute minimum: 

V(V 

DXMNSJ.SYS 
TT.SYS 
PIP.SAV 
LIBR.SAV 

4.1 Copying the Files 

Place FORTRAN distribution disk number 2 (OTSCOM) in drive 1 and 
the system (target) disk in drive 0. Make the following assignments: 

ASSIGN DXl: INP 
ASSIGN DXO: OUP 


Then: 


.RUN INP:OTSGEN 

Respond to the questions posed by the OTS installation program. This 
will place the indirect command file 0TS1 on the assigned output 
device (OUP:). Now you must implement your decision (see 2.4.1) 
either to include FORLIB in SYSLIB or to have a separate FORLIB. 

If you had decided to incorporate the OTS into SYSLIB, the 0TS1 you 
create might look like this (XXX represents an OTS inline code module) 

.R LIBR 

SYSLIB=SYSLIB,OUP:XXX/U,OTSCOM/U,N0VIR/U,V2NS/U/G 


$ERRS 

$ERRTB 

$VRINT 

A _ 


If you are installing a separate FORLIB, 0TS1 might look like this: 



. R LIBR f'lb 

F0RLIB=0UP:XXX/U,OTSCOM/U,N0VIR/U,V2NS/U/G 


$ERRS 

$ERRTB 

$VRINT 

/V 

















4.2 Editing the OTS onto the Second Diskette 

Now edit the file as follows: Change OUP: to INP: in the above 
command 1ine s. 

If you are building SYSLIB for the first time, delete the second 
occurrence of SYSLIB. 

4.2.1 Allocating Diskette Space for the OTS 

Be sure there are at least 180 contiguous free blocks on the output 
device, then make one of the following changes: 

Change SYSLIB to SYSLIB [180]? or, 

Change FORLIB to FORLIB[180]; 

in accordance with your choice of a default library. This allocates 
180 blocks to either SYSLIB or FORLIB, which should be adequate. If 
you find it necessary, squeeze the disk. 

When you have completed these operations, the edited file should 
appear as: 

.R LIBR f 

SYSLIB[180]=INP:XXX/U,OTSCOM/U,NOVIR/U,V2NS/U/G 


or .R LIBR £is 

FORLIB[18 0]=INP:XXX/U,OTSCOM/U,NOVIR/U,V2NS/U/G 

Finally, execute the file by entering: 

@0TS1 

The new library now will be on the output device. 

5 # o INSTALLATION VERIFICATION 

The final stage in the installation of FORTRAN IV into your RT-11 operat¬ 
ing system is verification — a test to demonstrate that FORTRAN has 
been correctly installed and is working. You verify by compiling the 
sample program (DEMO.FOR), linking it and executing it. See Appendix 
B.3 for a sample listing of DEMO.FOR. 


5.1 Compiling 

When FORTRAN is built on the system device (SY:), compile by using the 
keyboard monitor COMPILE or FORTRAN command: 

COMPILE INP:DEMO 

When FORTRAN is built on other than the system device, be sure that the 
device handler for OUP is loaded: 

LOAD DM 

if the systein device is RK05 and FORTRAN was built on an RK06. 

















Then issue the command: 


RU OUP:FORTRA 

* DEMO=DEMO 

* tc 


5.2 Linking 

If you have built FORLIB into SYSLIB, issue the command: 
LINK DEMO 

If you have built a separate FORLIB issue either command: 
LINK DEMO,FORLIB 

or 


LINK DEMO/LINKLIBRARY:FORLIB 



5.3 Executing 

To execute the demonstration program, issue the command: 
RUN DEMO 


5.4 Preserving the FORTRAN IV System 

Having verified the installation, your next step is to preserve the 
FORTRAN IV system. Do this by copying the necessary files of the FORTRAN 
system to a file structured (specifically, not magtape) device. This 
facilitates changing compiler defaults and applying patches to the 
FORTRAN system. Remember that if the back-up is DT or DX, there will be 
two such devices: the first for the compiler, the second for the OTS. 

The following files as shown in Table 5 comprise the FORTRAN system: 


Table 5 

FORTRAN System Files 



COMPILER 

DTI or 

FILES 

DX1 

OTS FILES 

DT2 or DX2 

OUP: 

DEFLTS.OBJ 

INP: 

CONVRT.OBJ 

OUP: 

OTSl.COM 

INP: 

FROOT.OBJ 

INP: 

REGALO.OBJ 

INP: 

NHD.OBJ 

INP: 

FO.OBJ 

INP : 

F21.0BJ 

INP : 

EAE.OBJ 

INP: 

FI.OBJ 

INP: 

F19.0BJ 

INP: 

EIS.OBJ 

INP: 

F 2.OBJ 

INP : 

PEEP.OBJ 

INP: 

FIS.OBJ 

INP: 

F3.0BJ 

INP: 

OBJGSD.OBJ 

INP: 

FPU.OBJ 

INP: 

F4.0BJ 

INP: 

F18.0BJ 

INP : 

OTSCOM.OBJ 

INP: 

F5.0BJ 

INP: 

F13.0BJ 

INP: 

V2S.0BJ 

INP: 

F6.0BJ 

INP: 

FI5.OBJ 

INP : 

V2NS.0BJ 

INP: 

F7.0BJ 

INP: 

F16.0BJ 

INP: 

NOVIR.OBJ 

INP: 

F8.OBJ 

INP: 

F17.0BJ 

INP : 

VIRP.OBJ 

INP: 

F9.0BJ 

INP: 

F4LINK.COM 

INP: 

VIRNP•OBJ 

INP: 

F10.OBJ 

INP: 

F4LTHR.COM 

INP: 

UNI.OBJ 

INP: 

LOOP.OBJ 

INP : 

F4LINL.COM 

INP: 

OTSGEN.SAV 

INP: 

Fll.OBJ 

INP: 

FORGEN.SAV 



INP: 

F12.0BJ 

OUP: 

FORBLD.COM 
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APPENDIX A 
DISTRIBUTION FILES 


The distribution media contain the following FORTRAN files. 



A. 1 



Compiler Files 

FORGEN.COM 

FROOT.OBJ 

F 0.OBJ 

FI.OBJ 

F2.0BJ 

F3.0BJ 

F4.0BJ 

F 5.OBJ 

F6.0BJ 

F7.0BJ 

F8.0BJ 

F9.0BJ 

FlO.OBJ 

LOOP.OBJ 

F11.OBJ 

F12.0BJ 

F13.0BJ 

F14.0BJ 

F15.OBJ 

F16.0BJ 

F17.0BJ 

CONVRT.OBJ 

REGALO.OBJ 

F21.0BJ 

F19.0BJ 

F20.OBJ 

PEEP.OBJ 

OBJGSD.OBJ 

F18.0BJ 

INLINE.OBJ 

THREAD.OBJ 

F4LINK.MT ) 

F4LTHR.MT > 

F4LINL.MT ) 

F4LINK.COM 

F4LTHR.COM 

F4LINL.COM 

FORTRA.HLP 


Compiler installation command file 


These appear only on the magtape 
distribution 


Compiler help file 
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DEMO.FOR 
FORGEN•SAV 


Installation verification program 
Compiler installation program 


A.2 OTS Library Files 

These files are distributed on a second tape or diskette in the TU56 
DECtape and RK01 Diskette kits. 


OTSGEN.COM 


OTS library installation command file 


The following OTS object modules: 

EIS.OBJ 
EAE.OBJ 
FIS.OBJ 
FPU.OBJ 
NHD.OBJ 
UNI.OBJ 
VIRNP.OBJ 
VIRP•OBJ 
NOVIR.OBJ 
V2NS.0BJ 
V2S.0BJ 
OTSCOM.OBJ 

OTSGEN•SAV OTS library configuration program 
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APPENDIX B 


FORTRAN IV INSTALLATION PROGRAM 


B.l Compiler Installation Program 

The following listing is a sample of the installation program dialog 
for compiler installation. 

ASS RKO OUP 

.ASS RK1 INP 

.0INPJFORGEN 

R PIP 

*SY:*.*«INP:FORTRA.HLPr DEMO.FOR » F4L*.COM 
*"C 

.RU INPJFORGEN 
Answer Questions with? 

• V or carriage return <<CR>) for information? 

YES(Y) for affirmation anything else for NO. 


* maximum of 56 lines are allowed per listing page. 

[s this acceptable? Y 

=> maximum of 136 characters are allowed in a formatted 
(ASCII) record. Is this acceptable? N 

rype the new value (must be greater than 3 and less than 4096) 

* maximum of 6 channels m3y be open at a given time. 

Is this acceptable? N 

rype the new value (must be greater than 0 and less than 16) . 

fhe FORTRAN compiler can compile system-specific OPEN and CLOSE 
statement keywords for RT-llr RSX-11? and RSTS/E systems. These 
statements are currently compiled for the following system* RT-11 


83\3\4 
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Is this acceptable? Y 

FORTRAN can produce inline code for EAE? EIS or FIS hardware? 
or it can produce threaded (THR) code which is hardware independent. 
Should the compiler produce EAE code? N 
Should the compiler produce EIS code? Y 

The inline compiler can optimize for SPEED or for SIZE. These 
optimizations are mutually exclusive. Do you want 
the optimization to be for SPEED? N\N\ 

Answer NO if the other optimization should be performed. 


The inline compiler can optimize for SPEED or for SIZE. These 
optimizations are mutually exclusive. Do you want 
the optimization to be for SPEED? Y 
Do you wish an inline only compiler? Y 
Compiler options selection complete. 
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6F0RBLD 


♦0F4LINL 

♦ R LINK 

♦OUR X FQRTRA*INP:FROOT///S 

♦ INP JFO *THREAD r OUP X DEFLTS/O 1 1 
♦INPJFl/0:i 

♦inp:f2/o:i 

♦inp:f3/o:i 

♦inp:f4/q:i 

♦inp:fs/o:i 

♦INPJFA/Gtl 

*INPJF7/0:i 

♦inp:f8/o:i 

*inp:f9/o*i 

♦inp:fio/o:i 

♦inp:loop/o:i 

♦inp:fii/o:i 

♦ t kit* ♦ it i n rn ♦ i 

■T* .b I { I ♦ I 4. *. / J ♦ J. 

♦inp:convrt/o:i 

♦inp:regalo/om 

♦inp:fi4/oji 

♦inp:f2o/oji 

♦inp:fi9/o:i 

♦inp:f21/oji 

♦inp:peep/o:i 

♦inp:objgsd/o:i 

♦inp:fi8/o:i 

♦inpjcdump/q:i// 

♦~C 


♦ DEL SY!F4L^C0M/N0a 


B. 2 OTS Installation Program 

The following listing is a sample of the installation program dialog 
for the OTS installation. 


♦ASS RKO OUP 


♦ASS RK1 INF 
♦eiNP*OTSGEN 

♦ R PIP 

♦OUP:EIS♦OBJ-INP X EIS♦OBJ 
♦OUP:EAE♦OBJ-INP X EAE♦OBJ 
♦OUP:FIS♦OBJ-INP X FIS♦OBJ 

♦oup : fpu ♦ obj-inp : fpu ♦ ob j 

♦OUP:NHD♦OBJ-INP X NHD♦OBJ 

♦oup juni ♦obj^inpjuni ♦obj 

♦OUP:UIRNP♦OBJ-INP:UIRNP♦OBJ 
♦OUP J VIRP♦OBJ-INPJUIRP♦OBJ 
♦OUP:NQVIR♦OBJ-INP:NOVIR♦OBJ 
♦OUP:V2NS♦OBJ*INP X U2NS♦OBJ 
♦OUP:U2S♦OBJ-INP X V2S♦OBJ 
♦OUP J OTSCOM♦OBJ=INP X OTSCOM♦OBJ 

♦ ~C 


B-2 







,RU INPtOTSGEN 
Answer Questions with? 

*?* or carriage return (<CR>) for information* 
YES(Y) for affirmation* anything else for NO. 


The following Questions refer to the building of the 
default FORTRAN library. 


The FORTRAN library components are normally added to 
the default system library* SYSLIB.OBJ. 

Is this acceptable? Y cvci t» nm 

The default FORTRAN library will be found in the file SY.iLIB.OBJ. 


The default FORTRAN library will be configured for the 

EIS hardware found on this machine. Is this acceptable? Y 

Is support for VIRTUAL arrays desired? N 

Do you wish an inline only library? Y 

Do you wish SIMRT support in your library? N 

The default FORTRAN library has been configured. 

Are any other FORTRAN libraries reauired? N 


STOP — 


.eOTSl 
.R LIBR 

*SYSLIB==SYSLIB * OUP t EIS/U *OTSCOM/U * NOVIR/U/G 

Global? *ERRS 

Global? HERRTB 

Global? *VRINT 

Global? 

*~C 

.DEL OUP.(EIS*EAE*FIS*FPU*NHD*UNI)♦OBJ/NOG 
.DEL OUP •(VIRNP *VIRP *NQVIR »V2NS*V2S *OTSCOM)/NQQ 


B.3 Installation Verification Program 

The following listing is an example of the FORTRAN verification pro- 
gram DEMO.FOR. 


irSTll FORTRAN IV V2 DEMONSTRATION TEST ***** 

INSTALLATION SUCCESSFUL IF NO ERROR MESSAGES 
WERE PRINTED ABOVE. 

**** FORTRAN DEMONSTRATION TEST COMPLETE ***** 
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APPENDIX C 


FORTRAN OTS 


C.l Assembling the OTS from Sources 

This appendix applies to the source version of the FORTRAN OTS as 
supplied in the RT-11 source kits. The sources are kept on logica 
device SRC: and listing and map files are output to LST:. 

You must modify BUILDF.COM to make the proper assignments for SRC:, 
S:! and Sw-T Remember that the sources must be on SRC: which must 
be file structured — that is, you cannot use magtape. The object 
files will be directed to OBJ: which also must be file structured, 
again Sling out magtape. Listing files will be directed to LST: 
but if you do not want listings, assign the null device to LST.. 


ASSIGN NL LST 

If you find it necessary to install the NL handler before you do this 
assign, use the monitor INSTALL command: 

INS NL: 

You can use magtape for the listings• 
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APPENDIX D 


CHANGING COMPILER DEFAULTS 


You can change the compiler defaults by following these steps: 

1. Mount the back-up device you created for compiler 

installation on a free drive and assign it to input 
(INP) • If the device is DECtape or floppy disk it 
is 1 of 2 (the OTS is 2 of 2). If the device is 
DECtape, the monitor ASSIGN command becomes: 


ASSIGN DTn: INP 

2. Assign the target device to output (OUP) . Assuming 

the system device to be RKn:, enter the monitor ASSIGN 
command 


ASSIGN RKn: OUP 


3. Next: 


RUN INP:FORGEN 


4. Then: 

@FORBLD 

5. Finally copy OUP:DEFLTS:OBJ and FORBLD.COM to INP by 
entering the command: 

COP OUP:DEF LTS.OBJ INP: 

COP OUP:FORBLD.COM INP: 
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APPENDIX E 
COMPILER PATCHES 


Follow these procedures for applying compiler patches: 

a. Mount the back-up device you created for the compiler 
installation on a free drive. This will be device 1 
of 2 for DECtape or floppy disk. 

b. Assign the device to INP:. Assuming DECtape, use the 
monitor ASSIGN command 

ASSIGN DTn: INP 

c. Assign the target device to OUP. Assuming RK05, use 
t-he monitor ASSIGN command 


ASSIGN RKn: OUP 

d. Copy the file DEFLTS.OBJ from INP to OUP. 

COP INP: DEFLTS.OBJ OUP 

e. Follow the directions in the patch and apply the patch 

f. Build the compiler: 


@INP:FORBLD 

g. copy any modified .OBJ or .COM files created by the 
patch to INP 


.2 


Follow these procedures for applying OTS patches: 


a. 


Mount the back-up device you 
stallation on a free drive. 

2 for DECtape or floppy disk. 


created for the OTS 
This will be device 


in- 
2 of 


b. Assign the device to INP. Assuming DECtape, use the 
monitor ASSIGN command 


ASSIGN DTn: INP 

c. Assign the target device to OUP. Assuming RK05, use 
the monitor ASSIGN command 

ASSIGN RKn; OUP 
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<3. Follow the directions in the patch and apply the patch 
e. Build the OTS as follows: 


n^ y h!?-?f e addin 9 more OTS modules to the 
coLand installation time, enter the 


@INP:OTS1 
otherwise: 


Enter the command 

RUN INP.-OTSOFM 


Then: 


COP PUP;OTSl.COM INP 
Finally: 

@INP:OTS1 
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APPENDIX F 
PROBLEMS/BUGS 




1. To obtain quick and accurate answers to the problems and bugs you 
might encounter, include the following with your Software Performance 
Report (SPR) . 

a. Problem: Compiler generates a crash dump. 

Your action: Send a copy of your program on a machine 
readable medium if the program is larger than one disk 
block. Also, send the console output and indicate what 
compiler installation options are available for your 
configuration and indicate what options you selected 
for the compilation that aborted. 

b. Problem: Compiler generates incorrect code (program 
does not work or traps at run-time). 

Your action: Send a copy of your program on a machine 
readable medium if the program is larger than one disk 
block. Include any required data files on a machine 
readable medium. Also, send the console output and 
indicate: 

1. What compiler options were selected. 

2. What OTS installation options were selected. 
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APPENDIX G 


NOTES ON INSTALLING FORTRAN ON 8K SYSTEMS 


G.1 Installing the Compiler 

1. Follow steps 1 and 2 of Section 3.2 of this manual. 

2. Print the contents of the file INPsFORGEN.COM 
on the terminal. 

TYPE INPsFORGEN.COM 

3. Type the contents of the file INPsFORGEN.COM down to 
but not including the line which reads 

@F0RBLD 

Note that as you run INPsFORGEN, the installation program 
will ask you questions about your system requirements. 
Answer these questions. 

4. Print the contents of the file FORBLD.COM 

TYPE FORBLD.COM 

This file will reference one of the following three files 
F4LINK.COM, F4LINL.COM, or F4LTHR.COM. 

5. Print the contents of the file referenced in step 4. 

TYPE F4L???.COM 

6. Type the contents of the file as printed in step 5. 

7. Type the remainder of the file INPsFORGEN.COM after 
the line which reads 

@F0RBLD 


G. 2 Installing the OTS 

1. Decide which of the following five arithmetic modules is 
suitable for your configuration (Refer to Section 2.5 if 
you are not certain)s 

NHD, EAE, EIS, FIS, FPU 


G-l 














In the subsequent Librarian Command String, this module 
will be referred to as XXX. 

Decide which of the following two subscripting modules 
is required for your application. Refer to Section 
2.4.3 if you are uncertain. Note that this module is 
optional (unnecessary) for an inline-only library. 

V2S, V2NS 

In the subsequent Librarian Command String, this module 
will be referred to as SSSS. 

Decide whether stand-alone support (UNI.OBJ) is required. 

Decide whether FORLIB should be incorporated into SYSLIB 
or not. (See Section 2.4.1 of this manual.) 

Creating the OTS library. 

a. FORLIB is to be incorporated into SYSLIB. 

♦ R LIBR 

* SYSLIB=SYSLIB,INP:XXX,OTSCOM,NOVIR[,SSSS](.U NIT/G 

Global? $ERRS -- - 

Global? $ERRTB 
Global? $VRINT 
Global? <RET> 

b. FORLIB is not to be incorporated into SYSLIB. 

■ R LIBR 

* FORLIB=INP:XXX,OTSCOM,NOVIR[, SSSS1 [,UNIl/G 

Global? $ERRS -- 

Global? $ERRTB 
Global? $VRINT 
Global? <RET> 
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Please cut along this line 
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RT-ll FORTRAN IV 
Installation Guide 
AA-5240B-TC 


READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 

use comments submitted on this form at the company's 
discretion. Problems with software should be reported 
on a Software Performance Report (SPR) form. If you 
require a written reply and are eligible to receive 
one under SPR service, submit your comments on an SPR 
form. 


Did you find errors in this manual? If so, specify by page. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Is there sufficient documentation on associated system programs 
required for use of the software described in this manual? If not, 
what material is missing and where should it be placed? 


Please indicate the type of user/reader that you most nearly represent. 

Q Assembly language programmer 
| | Higher-level language programmer 

□ Occasional programmer (experienced) 

0 User with little programming experience 
0 Student programmer 

□ Non-programmer interested in computer concepts and capabilities 


Organization 


Street- 

City___State 


Zip Code 
or 

Country 
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. RU I HP :FORGEN 
ANSWER QUESTIONS WITH: 

"?" OR CARRIAGE RETURN «CR» FOR INFORMATION, 
VES<Y> FOR AFFIRMATION, ANVTHING ELSE FOR NO. 


A MAXIMUM OF 56 LINES ARE ALLOWED PER LISTING PAGE. 

IS THIS ACCEPTABLE? V 

A MAXIMUM OF 136 CHARACTERS ARE ALLOWED IN A FORMATTED 
<flSCII> RECORD. IS THIS ACCEPTABLE? 

THIS VALUE CAN BE CHANGED ON A PER--PROGRAM BASIS WITH 
THE "XR" COMPILER SWITCH. ANSWER NO TO CHANGE THE 
PERMANENT DEFAULT VALUE. 

A MAXIMUM OF 136 CHARACTERS ARE ALLOWED IN A FORMATTED 
< ASCII.? RECORD. IS THIS ACCEPTABLE? NO 

TYPE THE NEW VALUE <MUST BE GREATER THAN 3 AND LESS THAN 4096> : 80 
A MAXIMUM OF 6 CHANNELS MAY BE OPEN AT A GIVEN TIME. 

IS THIS ACCEPTABLE? Y 

THE FORTRAN COMPILER CAN COMPILE SYSTEM-SPECIFIC OPEN AND CLOSE 
STATEMENT KEYWORDS FOR RT-11, RSX-11, AND RSTS.-'E SYSTEMS. THESE 
STATEMENTS ARE CURRENTLY COMPILED FOR THE FOLLOWING SYSTEM: RT-11 
IS THIS ACCEPTABLE? Y 

FORTRAN CAN PRODUCE INLINE CODE FOR ERE, EIS OR FIS HARDWARE, 

OR IT CAN PRODUCE THREADED <THR> CODE WHICH IS HARDWARE INDEPENDENT. 
SHOULD THE COMPILER PRODUCE EIRE CODE? NO 

SHOULD THE COMPILER PRODUCE EIS CODE? NO 

SHOULD THE COMPILER PRODUCE FIS CODE? Y 

THE INLINE COMPILER CAN OPTIMIZE FOR SPEED OR FOR SIZE. THESE 

OPTIMIZATIONS ARE MUTUALLY EXCLUSIVE. DO YOU WANT 
THE OPTIMIZATION TO BE FOR SPEED? Y 
DO YOU WISH AN INLINE ONLY COMPILER? Y 
COMPILER OPTIONS SELECTION COMPLETE. ^ 
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*OUP : FORTRAN INP : FROOTXXXS 

MNP : FO, THREAD, OUP : DEFL.TSXO :1 

MNP : F1X0 : 1 

MNP : F2X0 :1 

MNP:F3X0:1 

MNP:F4X0:1 

MNP:F5X0:1 

MNP : F6X0 :1 

••MNP : F7X0 :1 

MNP : F8X0 :1 

■•MNP . F9X0 :1 

MNP : F10XO :1 

■•MNP : LOOFv'O : 1 

MNP : F11X0 : 1 

-MNP : FI2X0 :1 

•■MNP : CONVRTXO : 1 

••MNP : REGALOXO : 1 

: MNP : F14X0 :1 

•-MNP : F20XO : 1 

•-MNP : F19X0 :1 

••MNP : F21X0 :1 

•MNP : PEEPXO : 1 

•••MNP : OBJGSDXO : 1 

••MNP : F18XQ : 1 

••MNP : CDUMPXO : 1XX 
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THE FOLLOWING QUESTIONS REFER TO THE BUII DING OF THE 
DEFAULT FORTRAN LIBRRRV . 

THE FORTRAN LIBRRRV COMPONENTS ARE NORMAL.LV ADDED TO 
THE DEFAULT SVSTEM LIBRARV, SVSL.IB. OBJ 
IS THIS ACCEPTABLE? NO 

I HE DEPAULI FORTRAN LIBRARV WILL BE FOUND IN THE: FILE FORLIB. OBJ. 

I HE DEFAULT FORTRAN LIBRARV WILL BE: CONFIGURED FOR THE: 

FIS HARDWARE FOUND ON THIS MACHINE. IS THIS ACCEPTABLE'"-* V 
IS SUPPORT FOR VIRTUAL ARRAVS DESIRED? NO 
DO VOU WISH AN INLINE ONL.V LIBRARV? V 
DO VOU WISH SIMRT SUPPORT IN VOUR LIBRARV? 

ANSWER VES IF VOU INTEND TO GENERATE STAND ALONE PROGRAMS; THEV 
REQUIRE SIMRT SUPPORT. 

DO VOU WISH SIMRT SUPPORT IN VOUR LIBRARV? V 
THE DEFAULT FORTRAN LIBRARV HAS BEEN CONFIGURED. 

ARE ANV OTHER FORTRAN LIBRARIES REQUIRED? 

ANSWER VES TO BUILD ALTERNATE: FORTRAN LIBRARIES. 

ARE ANV OTHER FORTRAN LIBRARIES REQUIRED? N 

STOP — 

. R L.IBR 

: +FORL IB-OUP : OTSCOM.-'U, NOVIRVIJ, V2NS.-T J.-'G 

?L IBR--F-FILE NOT FOUND 
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TERRTB 
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